VistA Patch Display                                                   Page: 1
=============================================================================
Run Date: AUG 15, 2017                      Designation: YS*5.01*122  TEST v
Package : MENTAL HEALTH                     Priority   : MANDATORY
Version : 5.01                              Status     : UNDER DEVELOPMENT
=============================================================================

Associated patches: (v)YS*5.01*92  <<= must be installed BEFORE `YS*5.01*122'
                    

Subject:  MENTAL HEALTH NCC PROJECT 5.01

Category:  ROUTINE

Description:
===========
 
This patch will add enhancements to the Inpatient Order Entry routines for
the National Clozapine T4 project.  Below is a list of all the applications
involved in this project along with their patch numbers:
 
   APPLICATION/VERSION                                   PATCH
   ---------------------------------------------------------------
   MENTAL HEALTH (MH) V. 5.01                          YS*5.01*122
   OUTPATIENT PHARMACY (OP) V. 7.0                     PSO*7*457 
   INPATIENT MEDICATIONS (IP) V. 5.0                   PSJ*5*327
   ORDER ENTRY/RESULTS REPORTING (OR) V. 3.0           OR*3*427
 
The patches (PSJ*5*327, PSO*7*457, YS*5.01*122, and OR*3*427) are 
being released in the Kernel Installation and Distribution System
(KIDS) multi-build distribution MENTAL HEALTH NCC PROJECT 5.01.
 
The purpose of this software package is to maintain compliance with 
Legislative,  and federal mandates, as well as and to add Clozapine Order
Checksing to the Inpatient Pharmacy application.  It also In addition,
this package adds real-time updateing functionality of the data sent to
the National Clozapine Server.
 
This specific patch contains the following functionality:
---------------------------------------------------------
The routines related to validation of the ANC Lab values, Local override
Reasons for both Inpatient/Outpatient Clozapine orders and daily
reporting of the Clozapine orders to the Hines Clozapine server will be
modified:
 
1.  The Mental Health CLAPI routine ^YSCLTST2 will be modified
    To use the new FDA guidelines for the ANC Lab values in 
    determining if overrides are required to continue processing.
 
2.  The override logic will be modified to allow local overrides
    If the ANC Lab values are >= 1000 and < 1500  
 
3.  The reporting logic will be modified to send the Clozapine order
    information to the Hines Clozapine server at the time order is
    finished by the pharmacist via a Mailman message.
 
4.  Add a new routine YSCLDIS that will discontinue Clozapine Patients
    status when
    a. An emergency 4 day registration was performed on a patient
       during hours when the NCCC is not available to register the
       patient into the Clozapine program.
    b. A patient was registered in the Clozapine Program and has not
       been prescribed any Clozapine at all in the first 28 days of
       being registered.
    c. A registered Clozapine patient has not been prescribed any
       Clozapine in the last 56 days.
 
5.  Add logic to send a Mailman message to NCCC notifying the NCCC
    that a patient was discontinued from the Clozapine program.
 
6.  Add new menu option to be used to manually transmit the previous
    day's Inpatients Clozapine Orders and the Outpatient Clozapine
    Prescriptions to the Hines Database server.  This option can
    also be scheduled to run nightly via Taskman.
 
7.  VistA option Weekly Clozapine Report [YSCL WEEKLY TRANSMISSION]
    will be set to out of order. If a user attempts to run this option
    they will receive 'Replaced by YSCL DAILY TRANSMISSION' message.
 
8.  The ^YSCLTST2 routine was modified to run REX^YSCLTST5 to manually
    execute the Retransmit of daily Clozapine orders (both Inpatient
    and Outpatient)  to the Hines database. This routine will also
    prompt the user for start and end dates.
 
9.  ^YSCLSERV routine was modified to accept a date range for the
    start and end dates to the retransmission of daily Inpatient and
    Outpatient Clozapine orders. The routine will accept a single date
    to retransmit a single day's Inpatient and Outpatient Clozapine orders.
 
10. Add 4 new data elements to the ^YSLC(603.03,1,0). Pieces 8,9,10 and
    11 are needed by Mailman to identify the servers that the YSCL DAILY
    TRANSMISSION will use to transmit the Clozapine Demographics, 
    Outpatient RX, and Inpatient Order transaction data to the Hines
    FOURWRD server for FDA reporting.
 
Patch Components
================
Files & Fields Associated:
 
File Name (Number)      Field Name (Number)              New/Modified/Deleted
------------------      -------------------              --------------------
CLOZAPINE PARAMETERS (#603.03)                               MODIFY
                        RX LAB PROD LISTENER (#8)            NEW
                        DEMOGRAPHIC PROD LISTENER (#9)       NEW
                        RX LAB TEST LISTENER (#10)           NEW
                        DEMOGRAPHIC TEST LISTENER (#11)      NEW
 
Forms Associated:
 
Form Name             File #       New/Modified/Deleted
---------             ------       --------------------
N/A
 
Mail Groups Associated:
 
Mail Group Name          New/Modified/Deleted
---------------          --------------------
N/A
 
Options Associated:
 
Option Name                   Type           New/Modified/Deleted
-----------                   ----           --------------------
YSCL DAILY TRANSMISSION       Run Routine      New
YSCL WEEKLY TRANSMISSION      Run Routine      Modified
 
Protocols Associated:
 
Protocol Name                     New/Modified/Deleted
-------------                     --------------------
N/A
 
Security Keys Associated:
 
Security Key Name                 New/Modified/Deleted
----------------------            --------------------
N/A
 
Templates Associated:
 
Template Name      Type      File Name (Number)  New/Modified/Deleted
-------------      ----      ------------------  --------------------
N/A
 
Additional Information:
 
New Service Requests (NSRs)
----------------------------
Request Name: National Clozapine Coordination Project
  Request ID: 20100703
 
Patient Safety Issues (PSIs)
-----------------------------
N/A
 
Remedy Ticket(s) & Overview
---------------------------
N/A
 
Test Sites:
----------
BATTLE CREEK
BOSTON
 
Documentation Retrieval Instructions
------------------------------------
Updated documentation describing the new functionality introduced by this
patch is available.
 
The preferred method is to SFTP the files from
ftp://DNS.URL      .DNS. This transmits the files from the first
available SFTP server. Sites may also elect to retrieve software directly
from a specific server as follows:

 Hines          DNS.DNS     .URL          <DNS//DNS.DNS     .URL       >
 Salt Lake City DNS.URL            <DNS//DNS.URL       >
 
The documentation will be in the form of Adobe Acrobat files.
  
Documentation can also be found on the VA Software Documentation Library 
at: http://DNS/
--------------------------------------------------------------------------
Title                                  File Name               FTP Mode
--------------------------------------------------------------------------
MENTAL HEALTH NCC PROJECT 5.01       MH_NCC_PROJECT_5_01.KID   (ASCII)
 
MENTAL HEALTH NCC PROJECT 5.01     MH NCC USER GUIDE_r0717.PDF (binary)
Technical Manual
   Inpatient Medications           psj_5_tm_r0517.PDF          (binary)
Deploy Install BO RB Guide
                  MH_NCC_Proj_5_01_OR_PSJ_PSO_YS_ig_r0717.PDF  (binary)
 
Patch Installation:
 
Pre/Post Installation Overview
------------------------------
N/A
 
Installation Instructions
-------------------------
This patch should take up to 20 minutes to install.
DO NOT QUEUE the installation of this patch.
 
To avoid disruptions, these patches should be installed during non-peak
hours when there is minimal activity on the system.
 
Pre-Installation Instructions
-----------------------------
 
1.  OBTAIN PATCHES
    --------------
    Obtain the host file MH_NCC_PROJECT_5_01.KID, which contains the
    following patches:
 
        YS*5.01*122
        PSO*7*457
        PSJ*5*327
        OR*3*427
 
     Sites can retrieve VistA software from the following SFTP addresses.
     The preferred method is to SFTP the files from:
 
                    download.DNS      .dns
 
     This will transmit the files from the first available SFTP server.
     Sites may also elect to retrieve software directly from a specific
     server as follows:
 
       Hines                   DNS.DNS     .URL       
       Salt Lake City          DNS.URL       
 
     The MH_NCC_PROJECT_5_01.KID host file is located in the
     anonymous.software directory. Use ASCII Mode when downloading the
     file.
 
2.  START UP KIDS
    -------------
    Start up the Kernel Installation and Distribution System Menu option
    [XPD MAIN]:
 
         Edits and Distribution ...
         Utilities ...
         Installation ...
 
    Select Kernel Installation & Distribution System Option: INStallation
                                                             ---
         Load a Distribution
         Print Transport Global
         Compare Transport Global to Current System
         Verify Checksums in Transport Global
         Install Package(s)
         Restart Install of Package(s)
         Unload a Distribution
         Backup a Transport Global
 
    Select Installation Option:
 
3.  LOAD TRANSPORT GLOBAL FOR MULTI-BUILD
    -------------------------------------
    From the Installation menu, select the Load a Distribution option.
 
    When prompted for "Enter a Host File:", enter the full directory path
    where you saved the host file MH_NCC_PROJECT_5_01.KID (e.g.,
    SYS$SYSDEVICE:[ANONYMOUS] MH_NCC_PROJECT_5_01.KID)
 
    When prompted for "OK to continue with Load? NO//", enter "YES."
 
    The following will display:
 
      Loading Distribution...
 
        MENTAL HEALTH NCC PROJECT 5.01
        YS*5.01*122
        PSO*7*457
        PSJ*5*327
        OR*3*427
      Use INSTALL NAME: MENTAL HEALTH NCC PROJECT 5.01 to install this
      Distribution.
 
4.  RUN OPTIONAL INSTALLATION OPTIONS FOR MULTI-BUILD
    -------------------------------------------------
    From the Installation menu, you may select to use the following
    options (when prompted for the INSTALL NAME, enter
    YS*5.01*122):
 
    a.  Backup a Transport Global - This option will create a backup
        message of any routines exported with this patch.  It will not
        backup any other changes such as DD's or templates.
    b.  Compare Transport Global to Current System - This option will
        allow you to view all changes that will be made when this patch
        is installed.  It compares all components of this patch
        (routines, DD's, templates, etc.).
    c.  Verify Checksums in Transport Global - This option will allow
        you to ensure the integrity of the routines that are in the
        transport global.
 
5.  INSTALL MULTI-BUILD
    -------------------
    This is the step to start the installation of this KIDS patch.  This
    will need to be run for the MENTAL HEALTH NCC PROJECT 5.01.
 
    a. Choose the Install Package(s) option to start the patch install.
    b. When prompted for the "Select INSTALL NAME:", enter YS*5.01*122  
 
    This Distribution was loaded on Mar 10, 2016@13:46:45 with header of 
    MENTAL HEALTH NCC PROJECT 5.01  ;Created on Mar 09, 2016@08:27:27
    It consisted of the following Install(s):
    YS*5.01*122    PSO*7.0*457    PSJ*5.0*327     OR*3.0*427
    Checking Install for Package YS*5.01*122
 
    Install Questions for YS*5.01*122

Incoming Files:


603.03    CLOZAPINE PARAMETERS  (Partial Definition)
Note:  You already have the 'CLOZAPINE PARAMETERS' File.
 
Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES// 
 
Checking Install for Package PSO*7.0*457
 
Install Questions for PSO*7.0*457
 
  c. When prompted "Want KIDS to Rebuild Menu Trees Upon Completion of
  d. Install? YES//", enter YES unless your system does this in a nightly
     TaskMan process.
  e. When prompted "Want KIDS to INHIBIT LOGONs during the install?
     YES//", enter NO.
  f. When prompted " Want to DISABLE Scheduled Options, Menu Options,
     and Protocols? NO//", enter NO.
  g. When prompted "Device: HOME//", respond with the correct device 
     but do not queue this install.
 
Incoming Files:
 
52.52     CLOZAPINE PRESCRIPTION OVERRIDES  (Partial Definition)
Note:  You already have the 'CLOZAPINE PRESCRIPTION OVERRIDES' File.
 
52.54     CLOZAPINE OVERRIDE REASONS  (including data)
Note:  You already have the 'CLOZAPINE OVERRIDE REASONS' File.
Data will NOT be added.
 
Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES// 
 
Checking Install for Package PSJ*5.0*327
  
Install Questions for PSJ*5.0*327
 
  h. When prompted "Want KIDS to Rebuild Menu Trees Upon Completion of
  i. Install? YES//", enter YES unless your system does this in a nightly
     TaskMan process.
  j. When prompted "Want KIDS to INHIBIT LOGONs during the install?
     YES//", enter NO.
  k. When prompted " Want to DISABLE Scheduled Options, Menu Options,
     and Protocols? NO//", enter NO.
  l. When prompted "Device: HOME//", respond with the correct device 
     but do not queue this install.
 
Incoming Files:
 
53.8      CLOZAPINE MEDICATION OVERRIDES
Note:  You already have the 'CLOZAPINE MEDICATION OVERRIDES' File.
 
55        PHARMACY PATIENT  (Partial Definition)
Note:  You already have the 'PHARMACY PATIENT' File.
 
Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES// 
 
Checking Install for Package OR*3.0*427
 
Install Questions for OR*3.0*427
 
Want KIDS to INHIBIT LOGONs during the install? NO// 
Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// 
 
Enter the Device you want to print the Install messages.
You can queue the install by enter a 'Q' at the device prompt.
Enter a '^' to abort the install.
 
DEVICE: HOME//   HOME  (CRT)
--------------------------------------------------------------------------------
 

 
Post-Installation Instructions
------------------------------
N/A


Routine Information:
====================


Routine Name: YSCL122P
    Checksum:
  Before: N/A        After: 1417520  **122**
Routine Name: YSCLDIS
    Checksum:
  Before: N/A        After: 31390614 **122**
Routine Name: YSCLSERV
    Checksum:
  Before: 64095727   After: 107528131 **18,22,26,47,61,69,74,90,92,122**
Routine Name: YSCLSRV1
    Checksum:
  Before: 2228786    After: 2762283 **61,69,74,90,122**
Routine Name: YSCLTEST
    Checksum:
  Before: 20876343    After: 19592894 **18,22,26,47,61,69,74,90,122**
Routine Name: YSCLTST2
    Checksum:
  Before: 49184088   After: 112388330  **18,22,26,47,61,69,74,90,92,122**
Routine Name: YSCLTST3
    Checksum:
  Before: 59491458   After: 68700177 **18,22,25,26,47,61,69,74,90,122**
Routine Name: YSCLTST4
    Checksum:
  Before: 15352155 After: 19360627 **92,122**
Routine Name: YSCLTST5
    Checksum:
  Before: N/A        After: 135657562 **122**
Routine Name: YSCLTST6
    Checksum:
  Before: N/A       After: 33307720 **122**


=============================================================================
User Information:  
  Entered By  :   WIPERT,RANDY T       Date Entered  :   DEC 29,2015
  Completed By:                        Date Completed:   
  Released By :                        Date Released :   
=============================================================================